home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 4: Phase Four / 17Bit_Phase_Four.iso / files / 3025.dms / 3025.adf / Golf Guru Doc < prev    next >
Encoding:
Text File  |  1994-03-07  |  22.0 KB  |  502 lines
  1. //////////////////////////////////////////////////////////////////////////
  2. /                                                                        /
  3. /                             Golf Guru V1.2                             /
  4. ////////////////////                                  ////////////////////
  5. /                       Written by Alan Bilsborough                      /
  6. /                                                                        /
  7. /             ************************************************           /
  8. /             *                                              *           /
  9. /             *         This is a SHAREWARE program.         *           /
  10. /             *                                              *           /
  11. /             * Please see the end of this file for details. *           /
  12. /             *                                              *           /
  13. /             ************************************************           /
  14. /                                                                        /
  15. //////////////////////////////////////////////////////////////////////////
  16.  
  17.  
  18. Index of Document :-  1) Introduction
  19.  
  20.                       2) Quick Start / Example Data
  21.  
  22.                       3) Steps to take before entering golf data
  23.  
  24.                       4) Using the Main Program
  25.  
  26.                       5) Future Development / Shareware Details
  27.  
  28. ---------------------------------------------------------------------------
  29.  
  30. IF YOU HAVEN'T DONE SO ALREADY, COULD YOU PLEASE MAKE A BACK-UP OF YOUR
  31. ORIGINAL GOLF GURU PROGRAM DISK.
  32.  
  33. ---------------------------------------------------------------------------
  34.  
  35. ONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONE
  36. ONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONE
  37. ONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONEONE
  38.  
  39. 1) INTRODUCTION
  40.  
  41.    Hello and thanks for taking the time to look at Golf Guru.
  42.  
  43.    This program was written to record and analyse your golf throughout the
  44. season. As with all analysis, the results can only be as good as the data
  45. input and this is where I hope Golf Guru will help. By making the input of
  46. data easy and the output interesting I hope you'll find that your golf will
  47. improve - in fact my big statement of this document is that I'll guarantee
  48. that if you use this program properly then it WILL improve your golf.
  49. You'll be able to see at a horrible glance how many of your shots have
  50. been putts - if this doesn't encourage you to practice putting more or
  51. concentrate a touch more over your putts then maybe seeing that you seem
  52. to be short on the vast majority of your approach shots will tell you that
  53. you're not being adventurous enough. Most of you will already have a good
  54. idea where your weak points are but it's amazing how focused these points
  55. become when you see them in black and white.
  56.  
  57.  
  58.    Golf Guru will record a round of golf in one of three ways :-
  59.  
  60.                  1) Log Only
  61.                  2) Text Scorecard 
  62.                  3) Graphic Scorecard
  63.  
  64.    Each of these options progressively records more information about your
  65. round of golf. For instance, Log only will record your total score, Text
  66. will record your score at each hole and Graphic will record every shot you
  67. play. The Graphic option is the option which distinguishes this program
  68. from other golf recording programs (as far as I'm aware) and elevates the
  69. program beyond being a simple database.
  70.  
  71.    The Graphic option, however, does have one drawback which is that the
  72. user must draw each hole of the course to be played. Unfortunately this is
  73. a major restriction but is a requirement which is fundamental to the
  74. program. However, if your only going to play a course a few times a year
  75. then most golfers wouldn't want to waste their time analysing a round of
  76. golf played on an unfamiliar course. In other words, Golf Guru is aimed at
  77. Club Golfers who play most of their golf on the one course. Other rounds
  78. can be recorded but not as comprehensively as the Graphic option allows.
  79. From now on they'll be no more talk of the programs restrictions because
  80. hopefully there is no more. For instance, you CAN draw every course you
  81. play on and you CAN record every shot, the only problem is that you won't
  82. have enough time to play golf!
  83.  
  84.    Note that there is a special program called Course Editor which allows
  85. you to draw each hole fairly easily (if I can do it then anyone can). This
  86. program should also be used to input other course details such as the
  87. scorecard for the course. The instructions for this program can be found
  88. in the Course Editor Doc.
  89.  
  90.    The following paragraph is for experienced users who always like to
  91. know how the program manipulates the data, don't worry if you don't
  92. understand it all as the program should take care of everything
  93. automatically. 
  94.  
  95.    The program was written using Amos Pro and compiled with the original
  96. compiler. The golf IFF files used for the Graphic option are not condensed
  97. and so can be improved using a paint program (I think, never tried this
  98. yet). The IFF files can be loaded from the disk to Ram or loaded directly
  99. from the disk (according to the settings in Preferences). This allows an
  100. infinite number of IFF files to be used in the program regardless of the
  101. amount of Ram available. Hard disk owners won't find much difference in
  102. the speed to load from hard disk compared to Ram. The course details
  103. (course name,hole names etc) are loaded from disk when required. The
  104. program will say that X amount of courses have been loaded but in reality
  105. all that is loaded is the name of the course, allowing the program to load
  106. it when required. The database of records i.e Log,Text and Graphic data are
  107. on one file and loaded to Ram. The file will have to be saved to disk to
  108. save any changes made. A back-up of the previous file is made which can be
  109. loaded by using the right mouse button when selecting the LOAD DATA
  110. option. The program will generally recognise three devices :- Df0:, Df1:
  111. and a volume name. This volume name will allow users to store their files
  112. on hard disk (explained in more detail later). Golf Guru and Course Editor
  113. will multi-task with workbench by pressing Amiga+A.
  114.  
  115.  
  116. TWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWO
  117. TWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWO
  118. TWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWOTWO 
  119.  
  120. 2) QUICK START / EXAMPLE DATA
  121.  
  122.    It's quite important to understand how Golf Guru works before any data
  123. is input. For this reason the program comes with an example course and
  124. example data. I'd strongly recommend that this data is loaded and
  125. experimented with.
  126.  
  127.    To load the example data enter Golf Guru and on the main title screen
  128. press the Help key. The program will then automatically load the course
  129. and data. To view the records in the database select the Database button.
  130. This screen lists all the records previously recorded, colour-coded
  131. according to the type of record it is (Log Only, Text or Graphic). To view
  132. any record in its entirety simply click on the record line.
  133.  
  134.    All options are available to the user at this point so creating new
  135. records, deleting them etc. can also be tried out. The example data cannot
  136. be saved to disk so the original data cannot be tampered with in any way.
  137. In other words, try anything you want at this stage to familiarise
  138. yourself with the program.
  139.  
  140.    The Course Editor program can also load the example course, so try out
  141. this program too. Note, that you can save the example course to disk so
  142. it's probably better not to use the Save Course option. No harm will be
  143. done though if you do use this option.
  144.  
  145.  
  146. THREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREE
  147. THREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREE
  148. THREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREETHREE
  149.  
  150. 3) STEPS TO TAKE BEFORE ENTERING GOLF DATA
  151.  
  152.    As mentioned before, there are some quite time consuming steps to do
  153. before Golf Guru can be fully used. Drawing individual holes is the most
  154. time consuming part and cannot be done in one night. There are steps
  155. however that the user can do to start the recording of data quickly.
  156.  
  157.    The first step is to input any course scorecard details that the user
  158. wants to input. The program at the moment can hold details of up to 20
  159. courses - hopefully this is more than adequate for normal use. Scorecards
  160. can be input via the Course Editor program. The instructions for doing
  161. this can be found in the Course Editor Doc.
  162.  
  163.    Once this is done the user then can record Log Only details and Text
  164. details in Golf Guru. Note that the user will be allowed into the
  165. Graphical recording screen but the user will be presented with a blank
  166. section of the screen where the hole picture should be - not very useful.
  167.  
  168.    When all of the holes have been drawn the user is then able to use the
  169. program in full. [As with all important data, please back-up your Iff
  170. files to another disk]. 
  171.  
  172.  
  173.    The second main task is to customise the variables used by the program.
  174. The program uses these variables to 1) describe the clubs used (Driver, 1
  175. Iron etc.), 2) the type of shot hit (Hooked, Sliced etc.), 3) the final
  176. position of the ball (Fairway, Green etc.) & 4) the description of putts
  177. (V Long, Short etc.).
  178.  
  179.    Due to the way the program stores data, it's important to have these
  180. descriptions in place before you input data. For instance, if the 3rd club
  181. variable is a 2 iron the program doesn't record it as a 2 iron but simply
  182. as number 3 (for the 3rd variable). Hence, if you change this description
  183. half way through the season, all previous data will still refer to
  184. variable 3 whether it has been changed or not. Note that you can add
  185. descriptions to the end of the variable list whenever you want as this is
  186. a brand new variable which would not have been referred to previously.
  187.  
  188.    To change variables the user should use the Customise Variables program
  189. - the instructions for which can be found in the Customise Variables Doc.
  190.  
  191.    Preparation of data disk - Floppy disk users are advised to save their
  192. courses and golf data to a separate formatted data disk. Golf data could
  193. theoretically be saved to the program disk, but this is not advised due to
  194. the lack of space left on the program disk. Always remember to keep a
  195. back-up of important data - particularly data which is constantly read
  196. and re-written to disks (such as Golf Guru Data). 
  197.  
  198.    Hard disk users should refer to the Hard Disk Users document which
  199. explains how Golf Guru uses volume names etc.
  200.  
  201.  
  202. FOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOUR
  203. FOREFOREFOREFOREFOREFOREFOREFOREFOREFOREFOREFOREFOREFOREFOREFOREFOREFORE
  204. FOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOURFOUR
  205.  
  206.  
  207. 4) USING THE MAIN PROGRAM
  208.  
  209.    Ok, a bit long-winded so far - hopefully you won't give up on the
  210. program before you get to this stage. I think once you start using the
  211. program you'll find all the work you've done up to now will have been worth
  212. it.
  213.  
  214.    The Main Menu screen has 7 buttons :-
  215.  
  216.                       a) Load Course
  217.  
  218.                       b) Change Current Course    
  219.  
  220.                       c) Load Data
  221.   
  222.                       d) Database
  223.  
  224.                       e) Analyse Season
  225.  
  226.                       f) Save Data
  227.  
  228.                       g) Exit
  229.  
  230.  
  231. a) Load Course
  232.  
  233.    If you want to utilise the Text or Graphic records then this option
  234. should be used to Load any courses which you have created (either
  235. Scorecards, Hole Pictures or both). All courses (except the Example
  236. Course) will be loaded automatically. An alert window will appear to
  237. inform you of how many courses and Hole Pictures have been loaded. Note,
  238. that if you only want to record or look at Log Only records then you don't
  239. need to load any courses.
  240.  
  241. b) Change Current Course
  242.  
  243.    Once your courses have been loaded you can change the current course
  244. via this button. Changing current course has only one function - when the
  245. user wants to input a new Text or Graphic record the current course will
  246. be the one used for Scorecard and Hole Pictures. If you make a mistake and
  247. enter the Create New Record option with the wrong current course then just
  248. delete the record, change to the correct current course and try again.
  249.  
  250.    Note, that there is no need to change the current course to view an
  251. existing record. The program will automatically load the course when you
  252. want to view this record.
  253.  
  254. c) Load Data
  255.  
  256.    Unless you are starting a new season or inputting data for the first
  257. time this option should be used to load your previous data. This data is
  258. loaded from your data disk to Ram and so if you make a mess of your
  259. database of records then simply press this button again to reload the
  260. data. You can only permanently change your data if you save the database
  261. file using the Save Data button.
  262.  
  263.    Golf Guru also saves a back-up file to your data disk. This file is a
  264. copy of your previous file and so can be called up if your present file is
  265. wrong or the file has developed a read-write error. To load the Back-Up
  266. file press this Load Data button using the right mouse button instead of
  267. the left.
  268.  
  269. **************************************************************************
  270.  
  271. There is a special option in the preferences page of Customise Variables
  272. which allows the user to automatically  Load Course and Load Data and go
  273. straight into the database. This option is explained more fully in the
  274. Customise Variables Doc.
  275.  
  276. **************************************************************************
  277.  
  278.  
  279. d) Database
  280.  
  281.    This is the main option and is used to create, edit and delete records.
  282. Remember that a record can be 1 of 3 different types :- 1) Log Only, 2)
  283. Text (scorecard) or 3) Graphic (every shot).
  284.  
  285.    The database screen is split into three parts. The main section is a
  286. list of all the records recorded to date. These are colour-coded according
  287. to the type of record it is. To view/edit any of these records click on
  288. the record line. The program will automatically load the relevant course
  289. (if required) and enter either the Text Scorecard, Graphic Scorecard or if
  290. a Log Only record, simply scroll up (2nd section of the database screen) to
  291. show the user the log details of the record.
  292.  
  293.     The third section of the database screen is the Create New Record
  294. section. Remember that if you want to create a Text or Graphic record then
  295. the course to be used must be the Current Course on the Main Menu screen.    
  296.  
  297. The following 3 sections will describe in more detail the 3 different
  298. types of record :- Log Only, Text and Graphic.
  299.  
  300.  
  301. d.1 Log Only
  302.  
  303.     This is the simplest type of record - the following data can be
  304. recorded with this type of record :- Date, Course Name, Number of Holes
  305. Played, Par of Course, Scratch Score of Course, Score, Handicap and a line
  306. of Comments.
  307.  
  308.  To delete this record, select the DELETE RECORD button (funnily enough!). 
  309.  
  310. **************************************************************************
  311.  
  312. NOTE : NUMERICAL BUTTONS ARE CHANGED BY USING THE LEFT MOUSE BUTTON TO
  313. INCREASE THE VALUE AND THE RIGHT MOUSE BUTTON TO DECREASE THE VALUE.
  314.  
  315. **************************************************************************
  316.  
  317. d.2 Text Scorecard
  318.  
  319.     This record records all of the above details plus individual hole
  320. scores and the tee played from. To view net or stableford scores press the
  321. relevant button. Note that the net or stableford score cannot be changed -
  322. only the gross score can be changed.
  323.  
  324.     Again this record can be deleted using the DELETE RECORD button.
  325.  
  326.  
  327. **** It should be noted that some buttons on the Text and Graphic screens
  328. **** cannot be changed directly. For instance, the score button cannot be 
  329. **** changed as it is the score of the individual scores which takes
  330. **** precendence over the total score. 
  331.  
  332.  
  333. d.3 Graphic Scorecard
  334.  
  335.     This is the most comprehensive type of record which records all of the
  336. above information plus individual shots including the club used, the type
  337. of shot and the final position of the shot. The wind direction and speed
  338. can also be recorded (these values are for the whole round and do NOT
  339. refer to the wind direction and speed of individual holes).
  340.  
  341.     The four main buttons on the Graphic screen are :- a) Input Hole, b)
  342. Review Hole, c) Review Round and d) Analyse Round.
  343.  
  344.     When the Input Hole button is pressed the user will be asked to
  345. input the tee and flag positions. Then the following information will have
  346. to be input :- Club Used, Type of Shot, Final Position Description and
  347. Finishing Position of Ball.
  348.  
  349.     If the club used was a putter then the program does not need the Type
  350. of Shot or Position Description but will instead ask for the type of putt
  351. i.e. Long, Short etc. Again the Finishing position of the ball will be
  352. asked for.
  353.  
  354.     At this point it's useful to stress the limitations of inputting the
  355. final position of the ball. If the holes are drawn to a reasonable
  356. accuracy (see Course Editor Doc for more details) then positioning the
  357. ball accurately will prove useful for the longer shots (100 yards/metres
  358. or more). This is due to the programs ability to calculate the distance
  359. the ball has travelled. With short shots, especially putts, there really
  360. isn't any point in worrying about the length of individual shots. For
  361. these shots the most important points are the description and the rough
  362. indicative line of the shot.
  363.  
  364.     If an error is made while inputting the hole details then finish the
  365. input by selecting the "In The Hole" button or one of the putt Holed
  366. buttons. The user can then reselect Input Hole and input the hole again.
  367.  
  368.     Once input, holes can be reviewed either individually (Review Hole) or
  369. collectively (Review Round). When either button is selected a group of 6
  370. video buttons will appear. These buttons represent the following options -
  371.  
  372.             Go Back One Hole                 Jump to Next Hole
  373.  
  374.             Slow Down Review                  Speed Up Review 
  375.  
  376.               Pause Review                      Stop Review
  377.    [Press button a 2nd time to resume]
  378.  
  379.    
  380.    The fourth main button on the graphic screen is Analyse Round. When
  381. selected the user will be able to view 4 types of graph and various
  382. statistics about the round input.
  383.  
  384.  
  385. e) Analyse Season
  386.  
  387.    At the time of writing this option has not been completed. The contents
  388. of Analyse Season will be discussed in the next section "Future
  389. Development". Please note that this option will only be available to
  390. Registered Users, the reasons for which are again explained in the next
  391. section.
  392.  
  393. f) Save Data
  394.  
  395.    After an editing session this option should always be chosen before
  396. exiting from the program. Save Data will back up your database to floppy
  397. disk or hard drive. Note that if your not happy with the information in
  398. the database then don't Save Data - this will keep your original data
  399. intact.
  400.  
  401.  
  402. FIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVE
  403. FIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVE
  404. FIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVEFIVE
  405.  
  406. 5) Future Development / Shareware Details
  407.  
  408.    It's appropriate that the above two topics are included in the same
  409. section. From previous experience of PD/Shareware programs I'm convinced 
  410. that the only way forward for such programs is through input from existing
  411. users. Without the support and ideas of other interested users then the
  412. program would sit in my hard drive gathering dust. If anyone has any
  413. suggestions to make then I'd be glad to hear from you. Note that ideas
  414. from Registered Users will be given preference.
  415.  
  416.    Authors planned developments for Golf Guru include :-
  417.  
  418.         ANALYSE SEASON
  419.             Best Eclectic Score
  420.             Scorecard - Average Score
  421.             Playback of Individual Holes
  422.             Playback of Best Graphic Eclectic Round
  423.             Graph of Handicap
  424.                      Scores
  425.                         Putts
  426.                              Penalty Shots
  427.                  Type of Shots
  428.             Pie Chart - Score (pars etc.)
  429.             
  430.         PRINTER FACILITY
  431.  
  432.         I'M BORED PAGE
  433.             Playback of Worst Graphic Eclectic Round
  434.             Membership Fees - Cost per Week
  435.                       Cost per Round
  436.                       Cost per Shot
  437.             Distance Walked
  438.             Most Used Club (except putter)
  439.             Least Used Club
  440.  
  441.  
  442. MY ABSOLUTE ULTIMATE AIM IS TO ANIMATE A WEE MAN OR WOMAN WHO CAN PLAY
  443. YOUR ROUND FOR YOU. THIS IS A TOUGH ONE FOR ME AS I CAN'T DRAW FOR TOFFEE,
  444. BUT EVERYONE'S ULTIMATE AMBITION IN LIFE SHOULD NEVER BE EASY.
  445.  
  446.  
  447.  
  448. REGISTRATIONREGISTRATIONREGISTRATIONREGISTRATIONREGISTRATIONREGISTRATION
  449. REGISTRATIONREGISTRATIONREGISTRATIONREGISTRATIONREGISTRATIONREGISTRATION
  450. REGISTRATIONREGISTRATIONREGISTRATIONREGISTRATIONREGISTRATIONREGISTRATION
  451.  
  452.    Registration for this program is £10. Registered Users will receive a
  453. registered copy of the program which will include the Analyse Season
  454. option in full. Also any help required will be gladly given. Registered
  455. Users will also receive any future versions of Golf Guru. In addition, any
  456. registered users who send me a disk and stamped-addressed envelope will
  457. receive a copy of "The Money Program" (Home Accounts program) which was a
  458. cover disk program on CU Amiga (so it must be good, mustn't it!).
  459.  
  460.    Non-registered users - if any help is required could you please include
  461. a stamped-addressed envelope. More than half of all letters I received from
  462. my last program was from non-registered users - pretending that they'd
  463. register if the problem was rectified got a bit monotonous after a while.
  464. Some letters were so convincing that I sent off the registered version
  465. before the registration fee, of course I didn't get the fee! I was quite a
  466. nice guy before my last program - now a I'm a hard nosed, selfish and
  467. extremely suspicious person - so don't mess with me!
  468.  
  469. Any correspondence should be sent to :-
  470.  
  471.             Mr. Alan Bilsborough
  472.             Flat 5,
  473.             7 Burnhill Quadrant,
  474.             Rutherglen,
  475.             Glasgow,
  476.             G73 1ER.
  477.  
  478. Could you please remember to mention Golf Guru somewhere in your letter.
  479.  
  480. Telephone calls are welcome :- 041 647 4872
  481.  
  482.  
  483.  
  484. Golf Guru (and its associated programs) was written with Amos Pro
  485. (Mandarin/Jawx).
  486.  
  487. The author cannot accept responsibility for damage caused to hardware
  488. whilst using Golf Guru or any other associated programs.
  489.  
  490. THEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEEND
  491. THEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEEND
  492. THEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEENDTHEEND
  493.  
  494.  
  495.    
  496.  
  497.  
  498.     
  499.               
  500.   
  501.       
  502.